home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / ezy_comm / ezcaller.zip / EZCALLER.DOC < prev    next >
Text File  |  1993-03-31  |  25KB  |  631 lines
  1.                       EZCaller v1.00 (c) 1993 Philip Dean.
  2.       The Eagle's Nest BBS, Sydney, Australia, 3:714/409, +61-2-451-0535.
  3.                    Ezycom Recent Callers Database and Viewer.
  4. -------------------------------------------------------------------------------
  5.  
  6.                        ** EZCaller v1.00 Instructions **
  7.  
  8. Introduction
  9. ------------
  10.  
  11. * What is EZCaller ?
  12.  
  13. EZCaller is a replacement for the in-built Ezycom Option 51 Menu Command.
  14. The Option 51 Menu Command allows you to display a list of Today's and 
  15. Yesterday's callers to the BBS.  Via a combination of a Caller List Database
  16. and two specially designed menus, EZCaller allows you to display the Caller
  17. List from up to NINE days previous.  The Caller List Database also contains a
  18. Best Ever Caller List (ie most number of the Calls to the BBS in one day)
  19. which can also be displayed.  Finally, EZCaller provides a brief explanation
  20. of the DidWhat? codes used in the Caller List displays.
  21.  
  22.  
  23. * Why EZCaller ?
  24.  
  25. EZCaller was initially developed as RACaller for RA systems.  The primary 
  26. motivation for RACaller was that RA reset the Caller list at midnight.  Hence, 
  27. those users who logged on soon after midnight never got to a see a list of the 
  28. recent callers to the BBS.  RACaller filled the gap by providing support for a 
  29. Yesterday's Caller list and, through logical progression, this was extended to 
  30. provide support for the Caller lists up to NINE days previous.
  31.  
  32. Another reason for writing RACaller was to enable the retention and display of 
  33. the Caller list from the day with the most ever number of calls to the BBS.
  34.  
  35. The third reason for RACaller was to make it possible to display the day's
  36. callers without having to logon to the BBS (ie from DOS, or within FrontDoor).
  37.  
  38. Not long after I got RACaller up and running, I switched my BBS software over 
  39. to Ezycom.  Although, Ezycom does provide support for a Yesterday's Caller 
  40. list, I decided to continue the development of the program, now as EZCaller, 
  41. as I wanted to retain the Best Ever Caller list function, support for Caller
  42. lists up to nine days previous and the ability to view the caller lists outside 
  43. of the BBS.  Also, I felt some explanation of the Ezycom DidWhat? codes would 
  44. be helpful and EZCaller provided an opportunity to give such an explanation.
  45.  
  46.  
  47.  
  48. Disclaimer
  49. ----------
  50.  
  51.     *  EZCaller is copyrighted material, however I am making it available
  52.        for people to use without the requirement of paying any fee.
  53.        
  54.     *  However, by using EZCaller, you agree to the following licence terms
  55.        and conditions.
  56.       
  57.        - You may not alter EZCaller in any way, and you may not decompile,
  58.          disassemble, or otherwise reverse-engineer it.
  59.          
  60.        - LIMITED WARRANTY. I do not warrant that the functions contained in
  61.          the software will meet your requirements or that the operation of
  62.          the software will be uninterrupted or error free. The ONLY Warrant
  63.          I give is that EZCaller will occupy space on your disk. The author
  64.          will not be held liable for any direct, indirect, incidental or
  65.          consequential damages resulting from the use of this program.
  66.          Your use of the program constitutes your agreement to this disclaimer
  67.          and your release of the author from any form of liability or
  68.          litigation.
  69.  
  70.  
  71.  
  72. Installing EZCaller
  73. -------------------
  74.  
  75. EZCALLER.EXE need not be in the current directory when running EZCaller, but 
  76. rather, can be in any directory on your Hard Disk.  If EZCALLER.EXE is not in 
  77. the current directory, then the directory it is in must be included in your 
  78. PATH statement, or alternatively, you must supply a FULL path and filename when 
  79. running EZCaller.
  80.  
  81.  
  82. EZCALLER.CFG, the configuration file, must be in the current directory when 
  83. invoking EZCaller, or else it must be located in the directory specified by the 
  84. EZY environment variable.  EZCaller checks the current directory first and only 
  85. reverts to checking the directory specified by the EZY environment variable if 
  86. EZCALLER.CFG is not found in the current directory.
  87.  
  88. If EZCaller cannot find EZCALLER.CFG in either the current directory or the 
  89. directory specified by the EZY environment variable then it will display 
  90. the EZCaller information screen and exit.
  91.  
  92.  
  93. If you have not set the EZY environment variable (you should have!), then you 
  94. must include
  95.  
  96. SET EZY=C:\EZY      
  97.  
  98. in your AutoExec.Bat file, where  C:\EZY is the path to your BBS directory.
  99.  
  100.  
  101. The EZCALLER.CFG file is a plain vanilla ascii file that looks as follows:-
  102.  
  103. BBS Name      <=- BBS Name to be displayed at top of Caller list (Max 25 Chars)
  104. *             <=- Key to View the Best Ever Caller List.
  105. Y             <=- Y or N - Use Page Pausing in EZCaller -L (outside) mode.
  106. Y             <=- Y or N - Use Colour on Local Display.
  107. Y             <=- Y or N - Add Command List to End of Caller List Files.
  108. Y             <=- Y or N - Use Ezycom Colour Codes.
  109. 30            <=- No. of seconds EZCaller will wait for Files to become free.
  110. TITLE=15      <=- Colour for Title.
  111. TUNDERLINE=12 <=- Colour for Title Underline.
  112. COPYRIGHT=11  <=- Colour for Copyright Message.
  113. HEADER=15     <=- Colour for List Header.
  114. HUNDERLINE=4  <=- Colour for Header Underline.
  115. CALLERNO=15   <=- Colour for Caller's Number.
  116. NAME=11       <=- Colour for Caller's Name.
  117. LINE=10       <=- Colour for Caller's Line.
  118. BAUD=10       <=- Colour for Caller's Baud.
  119. LOCATION=14   <=- Colour for Caller's Location.
  120. ONTIME=11     <=- Colour for Caller's Logon Time.
  121. OFFTIME=11    <=- Colour for Caller's Logoff Time.
  122. DIDWHAT=15    <=- Colour for Caller's DidWhat.
  123. CMDLINE=12    <=- Colour for End of Display Command List.
  124. DWHELP=11     <=- Colour for DidWhat? Help. 
  125. PROMPT=15     <=- Colour for '-L' Mode Prompt.
  126.  
  127.  
  128.  
  129. Use any text file editor to alter these options.
  130.  
  131.  
  132. * BBS Name
  133.  
  134.   BBS Name can be anything up to 25 Characters long (anything beyond 25 
  135.   characters will be truncated).
  136.  
  137.   Make sure there is nothing else on this line other than the BBS Name.
  138.   
  139.  
  140. * Best Ever Caller List Key
  141.  
  142.   Key the user must press to view the Best Ever Caller List (Default is '*').
  143.   If you change this key, you must use EZYMENU to make a corresponding change 
  144.   to EZCALLER.MNU.  The menu option to change is the one with 'EZCBEST' in the 
  145.   menu data field.  EZCALLER.CFG should just contain the character with NO 
  146.   quotation marks.
  147.   
  148.                
  149. * Page Pausing in EZCaller Local Mode On/Off  
  150.  
  151.   This option determines whether EZCaller uses Page Pausing (ie whether to give 
  152.   the 'More (Y,n), [C]ont :' prompt) when running EZCaller from outside of
  153.   Ezycom (ie if you run EZCaller from your Mailer to check the day's callers
  154.   without having to logon to the BBS).
  155.     
  156.   
  157. * Use Colour on Local Display
  158.  
  159.   Set this option to 'N' if your local display is Monochrome.
  160.   
  161.  
  162. * Add Command List to End of Caller List Files.
  163.  
  164.   This option determines whether or not EZCaller adds, to the end of the Caller 
  165.   List ASL/ASC files, the following line:
  166.   
  167.   [0] Today's Callers, [1-9] Previous Days, [*] Best Day, [E]xplain DidWhat?
  168.   
  169.   I have included this option for those who wish to use their own menus for 
  170.   displaying the Caller List files generated by EZCaller.  By setting this 
  171.   option to 'N', the above line is not added and you just have a straight file 
  172.   containing the Caller List.  You can then use different hotkeys to display 
  173.   the different files (rather than 0-9,*,E as indicated by the above line etc).
  174.   Or your menu might only offer the option to display the Caller Lists from the 
  175.   last three days or whatever you like.
  176.   
  177.  
  178. * No. of Seconds for EZCaller to Wait.
  179.  
  180.   This defines how many seconds EZCaller will wait for 'in-use' files to become 
  181.   free, ie how long to wait if EZCaller is in use elsewhere or how long to 
  182.   wait when trying to upate the Caller List Display files if the those files 
  183.   are in-use (ie being viewed on the BBS).
  184.  
  185.   
  186. * Colour Codes
  187.   
  188.   The Colour for each part of the display can be altered using the following
  189.   commands in EZCALLER.CFG:-
  190.  
  191.   TITLE=x       - Colour for Title                          Default=15
  192.   TUNDERLINE=x  - Colour for Title Underline                Default=12
  193.   COPYRIGHT=x   - Colour for Copyright Message              Default=11
  194.   HEADER=x      - Colour for List Header                    Default=15
  195.   HUNDERLINE=x  - Colour for Header Underline               Default=4
  196.   CALLERNO=x    - Colour for Caller's Number                Default=15     
  197.   NAME=x        - Colour for Caller's Name                  Default=11
  198.   LINE=x        - Colour for Caller's Line                  Default=10
  199.   BAUD=x        - Colour for Caller's Baud                  Default=10
  200.   LOCATION=x    - Colour for Caller's Location              Default=14
  201.   ONTIME=x      - Colour for Caller's Logon Time            Default=11
  202.   OFFTIME=x     - Colour for Caller's Logoff Time           Default=11 
  203.   DIDWHAT=x     - Colour for Caller's DidWhat               Default=15
  204.   CMDLINE=x     - Colour for End of Display Command List    Default=12
  205.   DWHELP=x      - Colour for DidWhat? Help                  Default=11
  206.   PROMPT=x      - Colour for '-L' mode Prompt               Default=15
  207.  
  208.   Valid Values for x 
  209.   
  210.    1=Blue               2=Green            3=Cyan             4=Red
  211.    5=Magenta            6=Brown            7=Light Gray       8=Dark Gray
  212.    9=Light Blue        10=Light Green     11=Light Cyan      12=Light Red
  213.   13=Light Magenta     14=Yellow          15=White
  214.  
  215.   
  216.  
  217.     
  218. The Caller List Database file (EZCALLER.DAT) and the Database Index file
  219. (EZCALLER.IDX) will be automatically generated when you first run 
  220. EZCaller.  The current contents of YESTER.BBS and TODAY.BBS will be 
  221. automatically placed into the Database, with YESTER.BBS becoming the initial 
  222. Best Caller List.  Initially, you will only have Caller Lists for Today, 1 Day 
  223. ago (Yesterday), and the Best Caller List.  The remaining Caller Lists will 
  224. emerge over the first eight days of running EZCaller.  The ASL/ASC display
  225. files will also be automatically generated.
  226.  
  227.  
  228. Now to run EZCaller within Ezycom (replacing the Option 51 Menu Command),
  229. first, place the two EZCaller menus, EZCALLTD.MNU and EZCALLER.MNU in your 
  230. Ezycom Menus Directory.
  231.   
  232. Next, replace the Option 51 Menu Command with an Option 1 (Goto Menu) Menu 
  233. Command.
  234.   
  235.   
  236. In the menu DATA field, place the following;
  237.   
  238.   EZCALLTD
  239.   
  240.   
  241. I provide the (R) Recent Callers option to users in my TOP (main) menu.
  242. If you will be calling the EZCaller menus from some menu other than TOP 
  243. then you will need to use EZYMENU to edit the data field of the LAST TWO
  244. lines of EZCALLER.MNU, replacing 'TOP' with the name of the menu which
  245. provides the Recent Callers Option on your system.
  246.           
  247.  
  248. You also must add the following line to your BBS Batch file so that just 
  249. after each logoff (including local logons) the EZCaller Caller List Database 
  250. is updated.
  251.   
  252.   
  253. If you wish to use Real Names in the display, add the following line:
  254.   
  255. EZCALLER -U      
  256.  
  257. Alternatively, to use Aliases in the display, add the following:
  258.   
  259. EZCALLER -U -A
  260.  
  261.  
  262. For example, my batch file looks as follows:
  263.   
  264.   ----<snip on>---------------------------------------------
  265.   :AFTEREZY
  266.   IF ERRORLEVEL 7 GOTO NET&ECHO
  267.   IF ERRORLEVEL 6 GOTO NETMAIL
  268.   IF ERRORLEVEL 5 GOTO ECHOMAIL
  269.   IF ERRORLEVEL 4 GOTO MODEMINIT
  270.   IF ERRORLEVEL 3 GOTO FOSSIL
  271.   IF ERRORLEVEL 2 GOTO RUNTIMEERROR
  272.   IF ERRORLEVEL 1 GOTO SETUPERROR
  273.   IF ERRORLEVEL 0 GOTO AFTEZY2
  274.   GOTO START
  275.  
  276.   :AFTEZY2
  277.   CD\EZY
  278.   EZCALLER -U         <=-  **** Here it is ******
  279.   EZCALLTL -U
  280.   IF NOT EXIST APPLIC.ASW GOTO START
  281.   COPY C:\TXTFILES\USERS.ASW + APPLIC.ASW C:\TXTFILES\USERS.ASW
  282.   DEL APPLIC.ASW
  283.   GOTO START
  284.   
  285.   :NETMAIL
  286.   CD \EZY
  287.   EZYNET -EXPORT
  288.   EZYPACK -VERBOSE
  289.   GOTO AFTEREZY2
  290.  
  291.   :ECHOMAIL
  292.   CD \EZY
  293.   EZYMAIL -SCAN -VERBOSE
  294.   GOTO AFTEZY2
  295.  
  296.   :NET&ECHO
  297.   CD \EZY
  298.   EZYMAIL -SCAN -VERBOSE
  299.   EZYNET -EXPORT
  300.   EZYPACK -VERBOSE
  301.   GOTO AFTEZY2
  302.   --------<snip off>----------------------------------------
  303.  
  304.   
  305.   NOTE: 'CD\EZY' changes the current directory to your Ezycom BBS Directory.
  306.   You should alter this as appropriate for your setup.
  307.  
  308.  
  309. EZCaller uses '=' and '-' as the default keys to exit the EZCaller menus.  If 
  310. you wish to change these, then you need to use EZYMENU to edit EZCALLER.MNU.
  311. The options to edit are the Type 1 (Return to <MENU> ) options.  If you wish to 
  312. have only one exit option, then you can delete one of the Type 1 menu options. 
  313. Alternatively, if you wish to have more exit options, you can add more Type 1 
  314. menu options.  You must also use F4 (in EZYMENU) to edit the Menu Prompt to 
  315. reflect at least one of the available Exit options.
  316.  
  317.  
  318.  
  319. Invoking EZCaller
  320. -----------------
  321.  
  322. USAGE:  EZCALLER <Command Line Option>  <-A> <-B> <-P>
  323.  
  324.  
  325. Valid Command Line Options:
  326.  
  327. -U        Update Caller List Database after Caller.
  328. -L        View Caller Lists from Outside of Ezycom.
  329. -S        Force Rebuild of ASL/ASC Caller List Files.
  330. -R        Force EZCaller to ReIndex the Caller List Database.
  331. -Ddate    Force EZCaller to reset the Dates of the Caller Lists.
  332. -Ex       Export the Caller List for DAY x to File (Export All Lists x=ALL)
  333. -Ixfname  Import Caller List File 'fname' to Day x (Best Ever List x=10)
  334. -?        Display EZCaller's Information Screen.
  335.  
  336. These switches are mutually exclusive, that is, you can only use one of these 
  337. three at any one time.
  338.  
  339. Any attempt to place two or more of these switches on the one command line 
  340. will result in only the first one being accepted.
  341.  
  342.  
  343.  
  344. *  -U  (Update Caller List Database)  Command Line Option
  345.  
  346.    Use this command line option to update the Caller List Database after a 
  347.    caller logs off (as per the installation instructions above).
  348.  
  349.    This is the default mode of EZCaller, thus you actually can omit the '-U' 
  350.    from the command line and simply use
  351.  
  352.    EZCALLER
  353.  
  354.  
  355.    If the last caller is the first caller since midnight, then EZCaller will 
  356.    automatically perform its own maintenance.  Hence, you are not required to 
  357.    do anything for EZCaller Maintenance.
  358.  
  359.    During EZCaller maintenance, the Caller List from nine days ago is removed, 
  360.    and the remaining Caller Lists are all cycled down one place.  EZCaller also 
  361.    checks to see if the day just passed was a new 'best' day (ie the most ever 
  362.    number of calls to the BBS in one day) and if so, replaces the 'best' day 
  363.    Caller List with the new 'best' day Caller List.
  364.   
  365.    Normally EZCaller will delete the previous day's Caller List Database at the 
  366.    end of the maintenance run.  If you wish to retain it, you should be using 
  367.    the following in your BBS Batch file:
  368.   
  369.    EZCALLER -U -B        (Use Real Names)
  370.   
  371.    EZCALLER -U -B -A     (Use Aliases)
  372.  
  373.    The previous day's Database will then be retained under the filename
  374.    EZCALLER.BAK.
  375.  
  376.  
  377.  
  378. *  -L  (View Caller Lists Outside of Ezycom)  Command Line Option.
  379.  
  380.    This option allows you to view the Caller Lists from outside of Ezycom, be 
  381.    it from DOS or from within another program such as your Mailer.
  382.  
  383.    eg   EZCALLER -L
  384.    
  385.   
  386.  
  387. *  -S  (Rebuild ASL/ASC Caller List Files)  Command Line Option.
  388.  
  389.    This option forces EZCaller to rebuild ALL the ASL/ASC Caller List 
  390.    Display files.  This is done automatically each day during EZCaller's 
  391.    maintenance, but you can use this option to ensure the Caller List Display
  392.    Files are fully up to date.
  393.    
  394.    eg  EZCALLER -S
  395.    
  396.  
  397. *  -R (ReIndex the Caller List Database)  Command Line Option.
  398.  
  399.    This option forces EZCaller to rebuild the Caller List Database Index file,
  400.    EZCALLER.IDX.
  401.  
  402.    Use this option if your Caller Lists become mixed up, or corrupted.
  403.    If you are getting Error #21, Error Reading EZCALLER.DAT, then this option 
  404.    may be effective in curing the problem.
  405.  
  406.    This option should retain the same Caller List dates. If there is any
  407.    problem with the dates then use EZCALLER -D to reset the dates.
  408.  
  409.  
  410.    eg EZCALLER -R
  411.    
  412.  
  413. *  -Ddate  (Reset the dates of the Caller Lists)  Command Line Option.
  414.  
  415.    Use this option, where 'date' is the date to use for the Best Ever Caller 
  416.    list, to reset the Caller List dates if the dates somehow become corrupted 
  417.    or incorrect.
  418.  
  419.    If you omit the date, then the current date of the Best Ever Caller list 
  420.    will be retained.
  421.         
  422.    Date can be of the form   'DD/MM/YY' or 'DDMMYY'.
  423.  
  424.    eg   EZCALLER -D23/03/93   (Reset Best Ever Caller List date to 23/03/93)
  425.    
  426.         EZCALLER -D230393     (Same as above)
  427.            
  428.         EZCALLER -D           (Don't Alter Best Ever Caller List date)
  429.    
  430.  
  431. *  -Ex  (Export Caller List for Day x to File)  Command Line Option.
  432.  
  433.    Use this option to Export a Caller List from the Database to a File, where:
  434.  
  435.    x=0  for Today's Caller List          (Exported to EZCTODAY.BBS)
  436.    x=1  for Yesterday's Caller List      (Exported to EZCDAY1.BBS)
  437.    x=2  for Caller List from 2 Days Ago  (Exported to EZCDAY2.BBS)
  438.    x=3  for Caller List from 3 Days Ago  (Exported to EZCDAY3.BBS)
  439.    x=4  for Caller List from 4 Days Ago  (Exported to EZCDAY4.BBS)
  440.    x=5  for Caller List from 5 Days Ago  (Exported to EZCDAY5.BBS)
  441.    x=6  for Caller List from 6 Days Ago  (Exported to EZCDAY6.BBS)
  442.    x=7  for Caller List from 7 Days Ago  (Exported to EZCDAY7.BBS)
  443.    x=8  for Caller List from 8 Days Ago  (Exported to EZCDAY8.BBS)
  444.    x=9  for Caller List from 9 Days Ago  (Exported to EZCDAY9.BBS)
  445.    x=10 for Best Ever Caller List        (Exported to EZCBEST.BBS)
  446.  
  447.  
  448.    Use x=ALL to export All 11 Caller Lists.
  449.  
  450.    eg EZCALLER -E1     (Export Caller List from 1 Day ago)
  451.       EZCALLER -EALL   (Export All Caller Lists)
  452.  
  453.  
  454.    
  455. *  -Ixfname  (Import Caller List for Day x from File)  Command Line Option.
  456.  
  457.    Use this option to Import a Callers List file into the Database where:
  458.   
  459.    fname = Filename of Caller List file to import.
  460.  
  461.            The import file must be an Ezycom 'TODAY.BBS' type file
  462.            (ie not a text file, but a file made up of Ezycom
  463.             ONTODAYRECORD records).
  464.             
  465.            The files TODAY.BBS, YESTER.BBS and the files Exported by EZCaller 
  466.            (EZCTODAY.BBS, EZCBEST.BBS, EZCDAY1.BBS, EZCDAY2.BBS etc) are valid 
  467.            files for importation.
  468.    
  469.    
  470.    x     = Day in Database to Import this Caller List to.
  471.            (x=0 for Today, x=1..9 for 1..9 Days Ago, x=10 for Best Ever Day)
  472.  
  473.  
  474.   This option, when used in conjunction with the '-Ex' Export option can be 
  475.   used to recreate your database if it becomes corrupted.  That is, if you 
  476.   regularly export all your caller lists (ie in your daily maintenance), then 
  477.   if the database becomes corrupted, you can simply delete EZCALLER.DAT, run 
  478.   EZCaller to initialise a new database, then use this Import command to import 
  479.   the Caller Lists you had previously exported.
  480.   
  481.   To re-import ALL the Caller List Export files (created by EZCALLER -EALL) in
  482.   one pass then rather than repeatedly using '-Ixfname', simply use '-IALL'.
  483.  
  484.   eg EZCALLER -I1YESTER.BBS
  485.      EZCALLER -I10EZCBEST.BBS
  486.      EZCALLER -IALL
  487.      
  488.  
  489. *  -?   (Display EZCaller Information Screen)  Command Line Option.
  490.  
  491.   Use this option to display the EZCaller information screen.  The information 
  492.   screen contains a brief Summary of EZCaller's Command Line Options and 
  493.   Optional Parameters.
  494.  
  495.   eg EZCALLER -?
  496.  
  497.  
  498.  
  499. EZCaller also accepts the following Optional Parameters:
  500.  
  501. -A      Use Aliases instead of Real Names in Caller List displays.
  502. -B      Retain the Caller List Database and Index Backup Files.
  503. -P      Pause at the End of EZCaller Operation.
  504.  
  505.  
  506.  
  507. *  -P  Pause Parameter
  508.  
  509.    The -P switch simply tells EZCaller to pause for 5 seconds after it has 
  510.    completed its operation in either '-U', '-S', '-Ddate', '-Ixfname' or '-Ex' 
  511.    modes.
  512.  
  513.  
  514. *  -B   Backup Parameter
  515.  
  516.    When EZCaller is run in any mode other than '-?' (Info Screen) or '-L' 
  517.    (Outside Viewing), EZCaller backs up EZCALLER.DAT and EZCALLER.IDX to 
  518.    EZCALLER.DA2 and EZCALLER.ID2 respectively.  Ordinarily, these backup files 
  519.    are deleted at the end of EZCaller's operation.
  520.    
  521.    Use the '-B' switch if you wish to retain these files at the end of 
  522.    EZCaller's Operation, rather than deleting them.
  523.  
  524.  
  525.  
  526. *  -A   Aliases Parameter
  527.  
  528.    The -A switch can be used with the -U,-L and -S options.
  529.  
  530.    It is recommended that if you are going to use the -A switch, then you 
  531.    should use it at ALL times, or else not use it at all.  This will ensure the 
  532.    consistency of the Caller List displays, preventing a mixture of Real Names 
  533.    and Aliases.
  534.  
  535.    If you do strike trouble with a mixture of Real Names and Aliases, use
  536.  
  537.    EZCALLER -S -A    to force ALL Caller List displays to use ALIASES, or use
  538.    EZCALLER -S       to force ALL Caller List displays to use REAL NAMES.
  539.  
  540.  
  541.  
  542. EZCaller Errors
  543. ---------------
  544.  
  545. If EZCaller strikes an error during its operation it will abort and write 
  546. details of the error to the Errors Log File, EZCALLER.ERR
  547.  
  548. If the error is Error #32, this indicates that EZCaller aborted because the 
  549. file EZCALLER.NOW exists.
  550.  
  551. The file EZCALLER.NOW is used by EZCaller to ensure that two copies of EZCaller 
  552. are not running simultaneously.  It is created when EZCaller is run in any mode 
  553. other than '-?' or '-L' and is removed after EZCaller's operations have been 
  554. completed.  If a second copy of EZCaller is invoked while a first is already 
  555. operating, then the second copy will wait the specified wait time for the first 
  556. copy to complete its operation and delete the EZCALLER.NOW file before the 
  557. second copy will operate.  If the EZCALLER.NOW file is not removed within the 
  558. wait time specified in EZCALLER.CFG then the second copy of EZCaller will abort 
  559. with Error #32.  As most EZCaller operations are brief, an Error #32 will 
  560. usually only occur because the EZCALLER.NOW file exists when it shouldn't 
  561. (ie it exists even though no other copy of EZCaller is currently operating).
  562.  
  563. Thus, if you do get an Error #32 then, provided there are in fact no other 
  564. copies of EZCaller currently operating, you should delete EZCALLER.NOW
  565.  
  566.  
  567.  
  568. Acknowledgements.
  569. -----------------
  570.  
  571. * EZCaller is written and complied with Borland Pascal with Objects v7.0
  572.  
  573. * Ezycom is the copyrighted work of Peter Davies.
  574.   Keep up the good work Peter and all those on the Ezycom team.
  575.  
  576. * Enormous thanks go to Matthew Taylor, Lake Macquarie BBS (3:622/407), for
  577.   pointing out the obvious (to all but me) that EZCaller did NOT need to 
  578.   be a door to perform its functions.
  579.   
  580.   The shift to the Database setup with EZCaller creating ASL/ASC files 
  581.   to be displayed by Ezycom, eliminated all the problems of Communications
  582.   handling, such as high speed modems, locked baud rates, non-standard
  583.   com ports, multiple i/o boards etc.  It also eliminated the messy copying of 
  584.   TODAY.BBS prior to each logon (as was required in previous versions of 
  585.   EZCaller) and the need to run a forced event at midnight to handle EZCaller's
  586.   maintenance.
  587.   
  588.   EZCaller is now significantly smaller (since there are no Comms routines) and 
  589.   the display for users is quicker than dropping to a door.
  590.   
  591.   
  592. * Special thanks also go to those who have beta tested EZCaller:
  593.   
  594.   Darren Gibbs,    Way Out West BBS,        3:713/888.
  595.   Dean Mackin,     500cc Formula One BBS,   3:712/218.
  596.   Shane Rampling,  OZ One BBS,              3:713/906.
  597.   Lloyd Bayley,    The RS232 Connection,    3:711/924.
  598.  
  599.   Thanks for all your time and patience, as well as your comments and 
  600.   suggestions.
  601.   
  602.  
  603. End Notes.
  604. ----------
  605.  
  606. As I said at the beginning, you are free to use EZCaller without the need to 
  607. register the program or pay any fee, although EZCaller remains copyrighted.
  608.  
  609. If you do find this program useful, send me a Netmail message to 3:714/409 
  610. (FidoNet) as I would love to hear from those who use the program. 
  611. Of course if you really love EZCaller and want to send a donation, then it will
  612. be gratefully accepted.
  613.  
  614. You can send any monies to:-
  615.  
  616. Philip Dean
  617. PO Box 62
  618. Forestville,
  619. NSW, Australia, 2087.
  620.  
  621.  
  622. If you encounter any bugs or problems with EZCaller, then send Netmail to
  623. me on 3:714/409 (FidoNet).
  624.  
  625. Also if you have any suggestions for improvements, let me know and I will see 
  626. what I can do.
  627.  
  628.  
  629. Philip Dean.
  630. Sysop, The Eagle's Nest BBS 3:714/409  March 1993.
  631.